home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr31 / findz116.zip / FINDZ.DOC < prev    next >
Text File  |  1993-05-01  |  18KB  |  595 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      
  8.      
  9.      
  10.      
  11.      
  12.      
  13.      
  14.      
  15.      
  16.      
  17.      
  18.                                    FindZ  v.1.15ß                                   FindZ  v.1.15ß
  19.                                  Directory Searcher                                 Directory Searcher
  20.                                          by                                         by
  21.                                     David Gilbert                                    David Gilbert
  22.                                           
  23.                                 in conjunction with:                                in conjunction with:
  24.                                 RAM-SOFT Development                                RAM-SOFT Development
  25.                                    2201 SW 127 CT                                   2201 SW 127 CT
  26.                                 Miami, Fl. 33175-1445                                Miami, Fl. 33175-1445
  27.      
  28.      
  29.      
  30.      
  31.      
  32.      
  33.      
  34.      
  35.      
  36.      
  37.      
  38.      
  39.      
  40.      
  41.      
  42.      
  43.      
  44.      
  45.      
  46.      
  47.      
  48.      
  49.      
  50.      
  51.      
  52.      
  53.      
  54.      
  55.      
  56.      
  57.      
  58.                Copyright (c) 1989, David Gilbert, ALL RIGHTS RESERVED
  59.      
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      
  74.      
  75.      
  76.                                   Copyright Notice                                  Copyright Notice
  77.      
  78.      
  79.      FindZ is Copyright (c) 1989 by David Gilbert, ALL RIGHTS RESERVED.
  80.      Documentation is Copyright (c) 1989, by David Gilbert, ALL RIGHTS RESERVED.
  81.      
  82.      
  83.                                   License Agreement                                  License Agreement
  84.      
  85.      
  86.      Permission is granted for you to use this software package (FindZ) for free
  87.      provided that you agree, abide, and follow the following guidelines:
  88.      
  89.           1)  You must not modify or change this product in any way, including,
  90.                but not limited to disassembly, patching, or examination.
  91.           
  92.           2)  You may not receive any compensation for distribution of this
  93.                program, above and beyond the cost of distribution.
  94.           
  95.           3)  You do not add, alter, or delete any file(s), documentation
  96.                accompanying this program.  You must include a copy of this
  97.                license when distributing this software.
  98.           
  99.           4)  If you are a US Government Agency, or other commercial user of
  100.                this product, you must register this program with the author.
  101.      
  102.      
  103.      Any other use, than the one spelled out in this License agreement is
  104.      strictly prohibited, without express written permission in advance.
  105.      
  106.      
  107.                                      Liability:                                     Liability:
  108.      
  109.      
  110.      This program is provided: "AS-IS".  Use of this program constitues no
  111.      agreement on the part of the user, nor the author.   In no event shall we
  112.      be liable for any loss of profit, or any other damage, including but not
  113.      limited to special, incidental, consequential or any other damage.  There
  114.      is no warranty covering this software, either expressed or implied.
  115.      
  116.      
  117.      Brand and Product names are Trademarks and Registered Trademarks (tm) of
  118.      their respective companies.
  119.      
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      
  140.      
  141.      
  142.      
  143.                                   Table of Contents                                  Table of Contents
  144.      
  145.      
  146.      
  147.      License Agreement.............................................  i
  148.      
  149.      Liability.....................................................  i
  150.      
  151.      
  152.      Background....................................................  1
  153.      Purpose and Use...............................................  1
  154.      System Requirements...........................................  1
  155.      
  156.      
  157.      Operation Guide
  158.      
  159.           Syntax...................................................  2
  160.           Options..................................................  2
  161.                Multiple............................................  3
  162.           Output...................................................  3
  163.                Notes...............................................  4
  164.                
  165.      Notes.........................................................  5
  166.      
  167.      Revision History..............................................  6
  168.      
  169.      
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      
  206.      
  207.                                     Background                                    Background
  208.                              (Why write the program?)
  209.      
  210.      
  211.      I originally set out to write a ZOO lister.  I had a possible use for it
  212.      (displaying the contents of ZOO archives to my BBS users), but what I
  213.      really wanted to do was find out about ZOO.  I had ZOO for several
  214.      years, but had not really had a chance to really examine it; not its
  215.      use, but how it stored things, and how well it was written.  In writing
  216.      this program, I examined the ZOO (v 1.51) sources [The only ones I had
  217.      at the time I was writing the program] to see how ZOO itself displayed
  218.      the file(s).
  219.      
  220.      After examining the ZOO sources and writing a simple ZOO contents
  221.      displayer, I realized that there was no way to "peek" into a ZOO file
  222.      during a global disk search; such as PKfind did.  At that point, I set
  223.      out to write such a utility.  I drew upon my own recursive directory
  224.      picker (from CRCheck, a file integrity checker) and added the previous
  225.      ZOO lister elements to it.   After a few days (Revision History) I had
  226.      created a Whereis? that included ZOO contents.
  227.      
  228.      
  229.                                  Purpose and Use                                 Purpose and Use
  230.      
  231.      
  232.           This program was designed to be a "whereis" program, but has been
  233.           modified, like PKfind to check inside archives as well.   This
  234.           program can be used to check inside ZOO archives, but not the ARC
  235.           archives.  It is not my intention that everyone convert to ZOO, but
  236.           this is designed for those of use that use the ZOO format instead
  237.           of the more traditional ARC format.  I support ZOO because of its
  238.           open policy, and because of its internal format.  It is a *much*
  239.           better program than ARC, or its clones are.
  240.      
  241.      
  242.                                System Requirements:                               System Requirements:
  243.      
  244.      FindZ requires a IBM-PC/XT/AT compatible computer system.  This includes
  245.      the PS/2 lines, Compaq, Tandy, Dell and many other clones.  PS/2 Models
  246.      70 and 80, the Compaq 386 & 386/20 should have no trouble with this
  247.      program. FindZ requires DOS 2.00 or better, and less than 64K of room to
  248.      operate safely.
  249.      
  250.      
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                  FindZ  v.1.15ß - Directory Search Program - Page 1
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.      
  272.      
  273.      
  274.                                  Operation Guide                                 Operation Guide
  275.      
  276.      
  277.      
  278.      FindZ is a recursive directory searcher.  FindZ can also search inside
  279.      of ZOO archives to match files with those you have selected.   It also
  280.      has the ability to display the path of the file that you are looking
  281.      for.
  282.      
  283.      
  284.                                      Syntax:                                     Syntax:
  285.      
  286.      
  287.      Usage: FindZ {CNPZ} [filename ... ]
  288.      
  289.      Where filename is an optional list of file names, and/or directories to
  290.      be searched.  Default is: \*.*
  291.      
  292.      Options are one of the following:
  293.      
  294.      
  295.              -N   Do not look inside ZOO archives
  296.              -C   Current directory only
  297.              -P   Display Path for each file
  298.              -Z   Only look inside ZOO archives
  299.      
  300.      FindZ searches for the appropriate file(s), in the selected (if any)
  301.      sub-directory.  FindZ then checks all sub-directories in the selected
  302.      directory for the appropriate file(s).
  303.      
  304.      
  305.                         Options are one of the following:                        Options are one of the following:
  306.      
  307.      
  308.           -N   Do not look inside ZOO archives
  309.                
  310.                This will eliminate the content of .ZOO archive(s) from the
  311.                listings.  This makes FindZ work just like any other whereis
  312.                program.  If the ZOO file is a part of the search pattern,
  313.                however, it will properly be displayed.  Can not be used with
  314.                the 'Z' option.
  315.                
  316.           -C   Current directory only
  317.                
  318.                This allows you to ignore searching of the sub-directories for
  319.                the specified file.  It is helpful in limiting the search if
  320.                you already know the location(s) of the ZOO files.
  321.                
  322.           -P   Display Path for each file
  323.                
  324.  
  325.  
  326.  
  327.  
  328.                  FindZ  v.1.15ß - Directory Search Program - Page 2
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.                This displays the path for the file(s) specified.  This allows
  338.                you to know where to go find the file, and/or where the file
  339.                is located for extraction/adding ability.
  340.                
  341.           -Z   Only look inside ZOO archives for file(s)
  342.                
  343.                This makes findz into a ZOO archive lister.  It gives you the
  344.                ability to only look inside the archives for files.  If you
  345.                know the file is inside one, this greatly cuts down on
  346.                superfluous files being displayed.  Can not be used with the
  347.                -N option.
  348.      
  349.      
  350.      Use of options:
  351.      
  352.      
  353.      You can use any one of the options, or all of them.  The options are to
  354.      be put all together (stacked) instead of being listed separately.  There
  355.      is no precedence, and the options can be used in any order.
  356.      
  357.      
  358.      Examples (of multiple options):
  359.      
  360.      C> FindZ -PN C:\*.DOC
  361.      
  362.      This would display all of the files that matched "*.DOC", but would not
  363.      look inside the ZOO archives to find them.  It would also display a path
  364.      listing of where the files could be found.
  365.      
  366.      C> FindZ -PC C:\ARCHIVES\*.EXE
  367.      
  368.      This would list all of the executable files, including their path, for
  369.      the directory 'C:\ARCHIVE\'.  It will not search any subdirectories of
  370.      this directories.
  371.      
  372.      C> FindZ -PZ C:\*.EXE
  373.      
  374.      This would look only inside of ZOO archives for any executable files,
  375.      and also display the path of the file(s).  The ZOO archives path will be
  376.      displayed.
  377.      
  378.      
  379.                                   Sample Output:                                  Sample Output:
  380.      
  381.      
  382.      C> FindZ C:\COMPILE\*.*
  383.      
  384.      
  385.      FindZ  v.1.15ß - Directory Searcher. Created on:  Feb  1 1989  16:41:30
  386.      Copyright (c) 1989 by, David Gilbert, ALL RIGHTS RESERVED.  -? for help
  387.      
  388.      Filename          Size      Date     Time    Path
  389.      -----------     --------- --------- -------- ----------------
  390.      ADIR.C               6428 25 Jan 89  0:09:46 C:\COMPILE\
  391.  
  392.  
  393.  
  394.                  FindZ  v.1.15ß - Directory Search Program - Page 3
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.      FINDZ.OBJ            6616 26 Jan 89 17:49:48 C:\COMPILE\
  404.      FINDZ.EXE           15234 26 Jan 89 17:49:50 C:\COMPILE\
  405.      FINDZ.C             17912 26 Jan 89 17:49:36 C:\COMPILE\
  406.      FINDZ.PRN           17760 26 Jan 89 15:50:08 C:\COMPILE\
  407.      FINDZ.TC             1690 25 Jan 89 15:57:02 C:\COMPILE\
  408.      INDENT.PRO            102 28 Dec 88 16:32:02 C:\COMPILE\
  409.      SEZ.ZOO              7390  7 Aug 87 22:37:28 C:\COMPILE\
  410.       - sez.doc           3036  7 Aug 87 22:37:28  44%     1714
  411.       - sez.exe           7406  7 Aug 87 22:25:30  26%     5456
  412.      TCCONFIG.TC          1690 12 Jan 89 19:34:12 C:\COMPILE\
  413.      TCPICK.TCP           1196 25 Jan 89  0:12:16 C:\COMPILE\
  414.      FINDZ.TXT             661 26 Jan 89 16:45:26 C:\COMPILE\
  415.      ADIR.C               6428 25 Jan 89  0:09:46 C:\COMPILE\ADIR\
  416.      ADIR.EXE             9884 25 Jan 89  0:12:14 C:\COMPILE\ADIR\
  417.      ADIR.TC              1690 16 Dec 88 14:02:12 C:\COMPILE\ADIR\
  418.      
  419.           16 File(s) found.
  420.      
  421.      
  422.      The files are displayed in the order of the directory, and are not
  423.      sorted.
  424.      
  425.      The files within the .ZOO file(s) are displayed with the following
  426.      information:
  427.      
  428.      
  429.           The 'SIZE' is the size of the file (extracted), the percentage is
  430.           the percentage the file is compressed, and the final figure is the
  431.           actual stored (compressed) size.  Refer to the ZOO documentation if
  432.           you are not sure of which is which.  The names inside the ZOO files
  433.           are in lowercase, and are displayed as such;  This is kept this way
  434.           to make the listings easier to read.
  435.      
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                  FindZ  v.1.15ß - Directory Search Program - Page 4
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.      
  470.      
  471.                                       Notes:                                      Notes:
  472.      
  473.      
  474.      Here is some more information about FindZ, while not a BUG list, it does
  475.      describe the behavior of FindZ, and lets you know what is and what is
  476.      not a real bug.   This version is a release version, but has not been
  477.      tested by anone except myself.   I don't trust myself!
  478.      
  479.      
  480.                       FindZ  v.1.15ß  -  Directory Searcher
  481.      
  482.            o  FindZ counts ZOO files in its totals when they themselves meet
  483.                 the criteria.   This may be confusing until you think about
  484.                 it.  If you do "*.*", you are (literally) asking for all
  485.                 files.
  486.      
  487.            o  FindZ needs to have a "SET" parameter to be able to have a
  488.                 default "path" of drives to select and look at.
  489.      
  490.            o  FindZ still needs to better optimize it's recursive directory
  491.                 functioning, but is much better than before.
  492.      
  493.            o  Source Code needs to be available.  Future releases may have
  494.               it available.  (Still debating, anyone really interested?)
  495.      
  496.      
  497.      I'm sure there are several other things that I have left out here.  I
  498.      feel that it has good value to be released in its present form.
  499.      
  500.      If you are interested in BETA testing THIS program, please contact me
  501.      (preferable by FidoNET mail, or through the BBS).
  502.      
  503.      I am interested in looking for some good BETA tester(s).  There are
  504.      several projects that I am/have worked on that need some good through
  505.      going over.
  506.      
  507.                            David Gilbert
  508.                            (305) 226-3310 - BBS Phone Number
  509.                            1:135/1.0      - BBS Network Address
  510.      
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                  FindZ  v.1.15ß - Directory Search Program - Page 5
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.      
  536.      
  537.                                  Revision History                                 Revision History
  538.      
  539.      Version  1.15ß:
  540.      
  541.           o  FindZ v. 1.00, and 1.15 *ARE* released beta programs, please
  542.                distribute them, and use them.
  543.           o  Added the -Z option of only looking inside the ZOO archives
  544.           o  FindZ now should properly handle filenames that do not have path
  545.                information.  (eg: *.doc, f*.*).
  546.           o  Re-adjusted the recursive directory system.  It now works much
  547.                better, and additions will be easier to make.
  548.           o  Accepts multiple command line arguments, so searching for
  549.                several file combinations at once is now possible.
  550.           o  FindZ will (now) not barf on a drive that does not have a disk
  551.                in it.  It will properly handle a search (eg: A:\*.*) even if
  552.                there is no disk in the drive.  Only one sticking point, if
  553.                you select a file search that does not contain a path, the
  554.                current drive is *not* checked to see if it is "ready", it is
  555.                assumed as a given.
  556.      
  557.      Version  1.00ß:
  558.      
  559.           o  While marked as a ß (Beta) program, this is the first release.
  560.                It is marked as a Beta program due to the fact that it has not
  561.                had any testing (by beta testers) prior to its release.
  562.                There may be some bugs in it that I am not aware of.
  563.           o  Added the Header describing the file information.
  564.           o  Fixed a problem in the counter, whereby each ZOO was only
  565.                counted once, even if there were more than 1 file in the ZOO
  566.                that matched the criteria.
  567.           o  Added the ability to see the path of the file. (-p option)
  568.      
  569.      Version 0.75ß:
  570.      
  571.           o  Added recursive directory searching
  572.           o  Added the -n (do not check inside ZOO archives)
  573.           o  Added the -c (do not check sub-directories: Current only)
  574.           o  Added the ability to check options "stacked" together.
  575.           o  Cleaned up the file display logic.
  576.      
  577.      Version 0.50ß:
  578.      
  579.           o  Added the ability to check files as well as files inside the ZOO
  580.                archives.
  581.           o  Added a directory searcher to look up file(s)
  582.      
  583.      Version 0.10ß:
  584.      
  585.           o  Viewer to look at ZOO archives.
  586.           o  Added the ability to look at all files in the ZOO archive.
  587.      
  588.  
  589.  
  590.  
  591.  
  592.                  FindZ  v.1.15ß - Directory Search Program - Page 6
  593.  
  594.  
  595.